home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / memory < prev    next >
Encoding:
Text File  |  1995-08-02  |  4.5 KB  |  110 lines
  1.  
  2. memory <subcommands>
  3.  
  4.      These commands are used for memory allocation.
  5.  
  6.      
  7.     memory freelist
  8.  
  9.      Display the storage allocator free list.  Each entry consists of
  10.      a starting segment, in hex, and a size, in decimal bytes.
  11.      
  12.      
  13.     memory ibufsize [<size>]
  14.  
  15.      (B)  Display or set the size of the buffers in the  interrupt
  16.      buffer  pool.   The size  should  be  set to the largest type of
  17.      buffer plus a header size of 8.  For example: If your ax.25 is
  18.      the only interface and a packet length of 512 is defined, the
  19.      ibufsize  should  be 512 + 72 + 8 = 592 .  The 72 is the ax.25
  20.      header (source , destination, 8 digipeaters, 1 control byte and 1
  21.      pid byte).  Default is 600.  See also the section on INTERFACE
  22.      BUFFERS (in the JNOS40 CONFIGURATION MANUAL, the relevant section
  23.      is called 'Interface Buffers').
  24.      
  25.     memory minalloc [<bytes>]
  26.  
  27.      Set the minimum number of bytes to allocate per malloc() call.
  28.      Setting a small value (32 or 64) might allow the realloc scheme
  29.      to work more effectively by preventing excessive memory
  30.      fragmentation.  Default = 0, no minimum allocation size.
  31.      
  32.      
  33.     memory nibufs [<number>]
  34.  
  35.      (B)  Display or set the number of interrupt buffer pool buffers.
  36.      If the number of buffers is set, the statistics in the 'memory
  37.      status' display are reset for number of interrupt buffer fails.
  38.      The minimum available value is set to the requested  number  of
  39.      buffers.  A rule of thumb for the number of buffers is to watch
  40.      the statistics and keep a minimum of 2  free  buffers.  Increase
  41.      or decrease as required. Default is 10.  See also the section on
  42.      INTERFACE BUFFERS (in the JNOS40 CONFIGURATION MANUAL, the relevant
  43.      section is called 'Interface Buffers').
  44.      
  45.      
  46.     memory sizes
  47.  
  48.      Display a histogram of storage allocator requested sizes.  Each
  49.      histogram bin is a binary order of magnitude (i.e., a factor of
  50.      2).
  51.      
  52.      
  53.     memory status
  54.  
  55.      Display a summary of storage allocator statistics.
  56.      
  57.      heap size 52560, avail 12880 (24%), morecores 150, coreleft 5872
  58.      
  59.  
  60.      The first line shows the total size of the internal heap, the
  61.      amount of memory available on the internal heap with the
  62.      percentage of the total heap size, next the number of times
  63.      memory has been requested from the Operating System, and the
  64.      amount of memory the OS has left over.
  65.      
  66.      allocs 16706, frees 16389 (diff 317), alloc fails 0, invalid
  67.      frees 0
  68.      
  69.      Next, the number of times memory has been allocated, and has been
  70.      freed is shown.  The difference is the number of buffers
  71.      currently allocated.  Alloc fails show up when the system is
  72.      running out of memory resources.
  73.      Invalid frees mean that memory was overwritten, and indicates the
  74.      system is about to lose sanity...
  75.  
  76.           garbage collections yellow 0, red 0
  77.      
  78.      Garbage collections free memory from network control structures
  79.      that could not have otherwise been freed.  Yellow garbage
  80.      collections are started when the total available memory, i.e.
  81.      avail+coreleft, becomes smaller then memthresh.  Red garbage
  82.      collections indicate that available memory got below memthresh/2
  83.      
  84.      interrupts-off calls to malloc 0, free 0
  85.      
  86.      These indicate calls to the memory allocator with interrupts off.
  87.      These requests are handled using the interrupt buffer pool, which
  88.      is configured by setting memory ibufsize and nibufs.
  89.      
  90.      Intqlen 9 Ibufsize 600 Iminfree 9 Ibuffail 0 Imaxrq 580
  91.      
  92.      This line shows the current number of interrupts buffers in the
  93.      interrupts buffer pool, the size of each buffer, the minimum
  94.      number of free buffers, and a count of times no interrupt buffer
  95.      was available when one was needed.  If Iminfree gets close to, or
  96.      becomes zero, you should increase the buffer pool size with the
  97.      'memory nibuf' command.  The statistics are reset when this
  98.      command is executed.  Also shown is the size of the largest request
  99.      for an interrupt buffer, to help establish an optimum Ibufsize value.
  100.      
  101.      
  102.     memory thresh [<size>]
  103.  
  104.      (B)  Displays or sets the memory threshold size in bytes.  If
  105.      free memory gets below this value, no more new connections can be
  106.      started and no new connections will be accepted.  This is an
  107.      attempt to preserve the system's sanity.
  108.      
  109.  
  110.